home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 August / macformat-027.iso / mac / Internet Software / Utilities / msw to html v1.5 / msw to html READ ME next >
Encoding:
Text File  |  1995-04-18  |  15.2 KB  |  224 lines  |  [TEXT/ttxt]

  1. msw to html version 1.5
  2. © Dan Berrios 1995
  3.  
  4.  
  5. INTRODUCTION
  6.  
  7. msw to html© is a simple application written in AppleScript®, Apple Computer's scripting system for the Macintosh, which converts Microsoft Word® 6.0 files to text files with html (hypertext mark-up language) tags.
  8.  
  9. REVISIONS
  10.  
  11. 1. msw to html© v1.5 appears to be more than TWICE AS FAST as msw to html© v1.0.  A complex document with title, two three-item lists, three headings, a 4 x 4 table, some preformatted text and about 10 paragraphs of text nowtakes only about 2 minutes to convert on a Quadra 610.
  12. 2. Paragraphs are now converted en masse rather than individually.
  13. 3. A bug which caused the script to abort when converting some types of lists has been fixed.
  14.  
  15. REQUIREMENTS
  16.  
  17. Mac with at least 4 megs of RAM.
  18. System 7.0.1 or later
  19. AppleScript®, version 1.1 or later, with the following Scripting Additions: choose file, open file (these were most likely installed with your copy of AppleScript®; if not, contact Apple Computers).
  20. Microsoft Word®, version 6.0 or later.
  21.  
  22. N.B.: Only version 6.0 of Microsoft Word® is scriptable, not previous releases.  Thus, this application will only work if Microsoft Word® 6.0 is installed on your computer.
  23.  
  24. INSTALLATION
  25.  
  26. Copy msw to html© to your hard disk.
  27.  
  28. Running msw to html©
  29.  
  30. 1. MAKE A COPY of the MS Word 6.0 file you wish to convert (choose Duplicate in the File menu in Finder with the file selected OR Save as...  in the File Menu in MS Word to save under another  file name).
  31. 2. Launch Microsoft Word® 6.0 if it is not currently running.
  32. 3. Launch (double-click) msw to html©.
  33. 4. A dialog box appears in which you must select a Microsoft Word® 6.0 document to convert to html.
  34. 5. If you care to, watch as your file is converted (choose MS Word under the MultiFinder).  This may take a while; a document with several, large tables may take up to several minutes.
  35. 6. After conversion, msw to html© will quit, but Microsoft Word® will remain open.  The document will be converted and the new html "text only" document SAVED UNDER THE SAME NAME.  (Be sure to save a copy of the Word® file BEFORE RUNNING THE PROGRAM). 
  36.  
  37. CONVERSION SPECS
  38.  
  39. The application currently supports the following conversions:
  40.  
  41. 1. "Bold" font to emphasis tag
  42. 2. "Bold, underline" font to strong emphasis tag
  43. 3. "Courier" font to preformatted text tag
  44. 4. Special characters ("&", "<",  ">", and """ [quotation mark]) to corresponding html entities
  45. 5. Microsoft Word® tables to html tables, with the following provisions:
  46.  
  47. N.B.: 1) Merged cells are not allowed and will not format correctly
  48.        2) Header cells should have all words in bold to format correctly
  49.        3) Captions can appear anywhere above a table but must have the Word® "Caption" style.
  50.              4) All cells should contain text or be completely empty (no paragraph marks, tab marks, etc.)
  51.  
  52. 6. Word® outline headings ("Heading 1" style, "Heading 2" style, etc.) to html heading tags  (H1, H2, etc.).  Note that you can apply these headings in Word® in either Outline view or in normal view. 
  53. 7. Bulleted Lists to unordered list tags.  The application recognizes bulleted lists only if lists have the "List Bullet" or "List" style in Word® or if bullets are made to precede each item using the Bullet button on the formatting toolbar.  Paragraphs preceded by manually typed bullets will not be recognized as bulleted lists by msw to html©.
  54. 8. Numbered Lists to ordered list tags.  The application recognizes numbered lists only if lists have the "List Number" style in Word® or if ordered numbers or letters are made to precede each item using the Numbered List button on the formatting toolbar.  Paragraphs preceded by manually typed numbers will not be recognized as numbered lists by msw to html©. 
  55. 9.  Word® "Title" style to html title tag.
  56.  
  57. N.B.:
  58.  
  59. 1.  All other font and paragraph styles are currently ignored.  Conversion of other styles to HTML tags may not be wise as they have yet to be officially adopted into HTML standards (e.g., blinking text, text colors, etc.). 
  60. 2.  All converted text appears in the body of the html document.  
  61. 3. The tables conversion specs are those currently most commonly used, but not necessarily those which will be finally adopted into future HTML standards.  Convert at your own risk.
  62.  
  63. ORDERING INFO/EVALUATION PERIOD --------- Important ----------------------
  64.  
  65. This program is NOT freeware.  It is shareware.  You are granted a 10 day limited-use evaluation period (see below).  After this period, If you choose to continue to use this program, you must purchase it from the author.  
  66.  
  67. Single-User License---------------$15.00
  68. Site-license (5 mile radius)--------$50.00
  69.  
  70. Provided with this license will also be:
  71.  
  72. 1) The editable source code for the program so that you may tailor conversions as your needs dictate
  73. 2) Written permission to alter this source code
  74. 2) The latest version of the program if available, including more html style conversions not currently implemented
  75.  
  76. Be sure to include your mailing address if different from that on your check or money order.  DO NOT SEND CASH.
  77.  
  78. SEND TO:
  79.  
  80. Daniel C. Berrios
  81. 3145 Geary Blvd., #413
  82. San Francisco, CA  94118
  83.  
  84. e-mail address: DanielB20@aol.com
  85.  
  86. msw to html version 1.0
  87. ©Dan Berrios 1995
  88.  -----------------------------------------------------------------------       
  89. msw to html© Terms and Conditions of Use
  90.  
  91. 1. Distribution of msw to html©. msw to html© Software, documentation, and
  92. license agreement are distributed by the Author in an archive or floppy
  93. disk (the archive) comprising the complete msw to html© distribution. You are
  94. authorized to redistribute this unmodified archive for evaluation
  95. purposes only. Extracting the msw to html© Software and/or data from the
  96. archive constitute acceptance of the license agreement.
  97.  
  98. 2. Evaluation of msw to html©. You are granted a period of 10 days from the
  99. receipt of the msw to html© Software and documentation to evaluate msw to html©. During this time, you may use the msw to html© software to created html documents. During the evaluation period, you may not use the msw to html© software to distribute information via the World Wide Web for profit or gain. At the end of the 10 day evaluation period, you must agree to the msw to html© License Agreement and purchase the msw to html© Software license from the
  100. author, or destroy all copies of msw to html© Software and related documentation.
  101.  
  102. 3. Use of msw to html© Software. Use of the Software is covered by the terms
  103. within the license agreement.
  104.  
  105. 4. Individual User and Site License Costs. msw to html© Software, documentation, and related documentation must be licensed from the Author or an authorized representative of the Author. Federal, state, and local government entities, commercial organizations, educational institutions, and individuals may license msw to html© Software and documentation at the rates specified in the "Ordering Info" section of this document.
  106.  
  107. A Single-User license allows the user to install and use msw to html© Software
  108. and data on one computer. A Site-License allows an unlimited number of
  109. copies to be installed by an organization on the organization’s computer
  110. systems within a 5 mile radius of a specified location.
  111.  
  112. 5. Support and Upgrades. All support for msw to html© will be provided via
  113. electronic mail or U.S. Mail with the Author.
  114.  
  115. This license will entitle the registered owner of  msw to html© Software to 
  116. obtain free updates to msw to html© Software for a period not less than
  117. 1 year from the date the license is assigned. This update period may be 
  118. extended on a yearly basis after the initial period has expired for an
  119. annual support fee not to exceed 50% of the original license fee per year.
  120. ________________________________________________________
  121.  
  122. msw to html© Software License Agreement
  123. Copyright 1995, Daniel C. Berrios
  124.  
  125. PLEASE READ THIS LICENSE CAREFULLY BEFORE INSTALLING OR USING THE msw to html© SOFTWARE.  BY DOWNLOADING, INSTALLING, AND/OR USING THE SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE TERMS OF THIS LICENSE.  IF YOU DO NOT AGREE
  126. TO THE TERMS OF THIS LICENSE, YOU ARE NOT AUTHORIZED TO DOWNLOAD,
  127. INSTALL, AND/OR USE THIS SOFTWARE.
  128.  
  129. 1. License.  The msw to html© application software accompanying this License, whether on disk, in read only memory, or on any other media or networked storage device (the "msw to html© Software") and related documentation (the “data”) are licensed to you by Daniel C. Berrios (the “Author”). You own the disk on
  130. which the msw to html© Software and data are recorded but the Author and/or
  131. the Author’s Licensor(s) retain title to the msw to html© Software and related
  132. documentation. This License allows you to install and use the
  133. msw to html© Software and data on a single computer and make one copy of the
  134. msw to html© Software and data in machine-readable form for backup purposes
  135. only.  You must reproduce on such copy the Author’s copyright notice and
  136. any other proprietary legends that were on the original copy of the
  137. msw to html© Software and related documentation. You may also transfer all your license rights in the msw to html© Software and related documentation, the backup copy of the msw to html© Software and related documentation, and a copy of this License to another party, provided the other party reads and agrees to accept the terms and conditions of this License.
  138.  
  139. 2. Restrictions.  The msw to html© Software and related docuementation contains copyrighted material, trade secrets and other proprietary material and in order to
  140. protect them you may not decompile, reverse engineer, disassemble or
  141. otherwise reduce the msw to html© Software to a human-perceivable form without the Author's written permission.  You may not modify, network, rent, lease, loan, distribute or create derivative works based upon the msw to html© Software in whole or in part without the Author's written permission. You may not electronically transmit the licensed msw to html© Software from one computer to another or over a network.
  142.  
  143. 3. Termination.  This License is effective until terminated.  You may
  144. terminate this License at any time by destroying the msw to html© Software and related documentation and all copies thereof.  This License will
  145. terminate immediately without notice from the Author if you fail to
  146. comply with any provision of this License.  Upon termination you must
  147. destroy the msw to html© Software, and related documentation and all
  148. copies thereof.
  149.  
  150. 4. Export Law Assurances.  You agree and certify that neither the msw to html©
  151. Software nor any other technical data received from the Author, nor the
  152. direct product thereof, will be exported outside the United States except
  153. as authorized and as permitted by the laws and regulations of the United
  154. States. If the msw to html© Software has been rightfully obtained by you
  155. outside of the United States, you agree that you will not re-export the
  156. msw to html© Software nor any other technical data received from the Author,
  157. nor the direct product thereof, except as permitted by the laws and
  158. regulations of the United States and the laws and regulations of the
  159. jurisdiction in which you obtained the msw to html© Software.
  160.  
  161. 5. Government End Users.  If you are acquiring the msw to html© Software and
  162. related documentation on behalf of any unit or agency of the United States Government, the following provisions apply.  The Government agrees:
  163.  
  164. (i) if the msw to html© Software and data are supplied to the Department of
  165. Defense (DoD), the msw to html© Software and data are classified as
  166. "Commercial Computer Software" and the Government is acquiring only
  167. "restricted rights" in the msw to html© Software, its documentation and data
  168. as that term is defined in Clause 252.227-7013(c)(1) of the DFARS; and
  169.  
  170. (ii) if the msw to html© Software and data are supplied to any unit or agency
  171. of the United States Government other than DoD, the Government's rights in
  172. the msw to html© Software and related documentation  will be as defined in
  173. Clause 52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause
  174. 18-52.227-86(d) of the NASA Supplement to the FAR.
  175.  
  176. 6. Disclaimer of Warranty on msw to html© Software.  You expressly acknowledge
  177. and agree that use of the msw to html© Software and related documentation is at your sole risk.  The msw to html© Software and related documentation are provided AS IS
  178. and without warranty of any kind and the Author and the Author's
  179. Licensor(s) (for the purposes of provisions 6 and 7, the Author and the
  180. Author's Licensor(s) shall be collectively referred to as "the Author")
  181. EXPRESSLY DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT
  182. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  183. PARTICULAR PURPOSE.  THE AUTHOR DOES NOT WARRANT THAT THE FUNCTIONS
  184. CONTAINED IN THE msw to html© SOFTWARE WILL MEET YOUR REQUIREMENTS, OR THAT THE OPERATION OF THE msw to html© SOFTWARE WILL BE UNINTERRUPTED OR ERROR-FREE, OR THAT DEFECTS IN THE msw to html© SOFTWARE WILL BE CORRECTED. 
  185. FURTHERMORE, THE AUTHOR DOES NOT WARRANT OR MAKE ANY REPRESENTATIONS
  186. REGARDING THE USE OR THE RESULTS OF THE USE OF THE msw to html© SOFTWARE AND
  187. DATA OR RELATED DOCUMENTATION IN TERMS OF THEIR CORRECTNESS, ACCURACY,
  188. RELIABILITY, OR OTHERWISE.  NO ORAL OR WRITTEN INFORMATION OR ADVICE
  189. GIVEN BY THE AUTHOR OR A REPRESENTATIVE AUTHORIZED BY THE AUTHOR SHALL
  190. CREATE A WARRANTY OR IN ANY WAY INCREASE THE SCOPE OF THIS WARRANTY. 
  191. SHOULD THE msw to html© SOFTWARE PROVE DEFECTIVE, YOU (AND NOT THE AUTHOR OR A REPRESENTATIVE AUTHORIZED BY THE AUTHOR) ASSUME THE ENTIRE COST OF ALL
  192. NECESSARY SERVICING, REPAIR OR CORRECTION. SOME JURISDICTIONS DO NOT
  193. ALLOW THE EXCLUSION OF IMPLIED WARRANTIES, SO THE ABOVE EXCLUSION MAY NOT
  194. APPLY TO YOU.
  195.  
  196. 7. Limitation of Liability.  UNDER NO CIRCUMSTANCES INCLUDING NEGLIGENCE,
  197. SHALL THE AUTHOR BE LIABLE FOR ANY INCIDENTAL, SPECIAL OR CONSEQUENTIAL
  198. DAMAGES THAT RESULT FROM THE USE OR INABILITY TO USE THE msw to html© SOFTWARE OR RELATED DOCUMENTATION AND DATA, EVEN IF THE AUTHOR OR AN AUTHORIZED REPRESENTATIVE OF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  SOME JURISDICTIONS DO NOT ALLOW THE LIMITATION OR EXCLUSION OF LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES SO THE ABOVE LIMITATION
  199. OR EXCLUSION MAY NOT APPLY TO YOU. In no event shall The Author’s total
  200. liability to you for all damages, losses, and causes of action (whether
  201. in contract, tort (including negligence) or otherwise) exceed the amount
  202. paid by you for the msw to html© Software and data.
  203.  
  204. 8. Controlling Law and Severability.  This License shall be governed by
  205. and construed in accordance with the laws of the United States and the
  206. State of California, as applied to agreements entered into and to be performed
  207. entirely within California between California residents.  If for any reason a court
  208. of competent jurisdiction finds any provision of this License, or portion
  209. thereof, to be unenforceable, that provision of the License shall be
  210. enforced to the maximum extent permissible so as to effect the intent of
  211. the parties, and the remainder of this License shall continue in full
  212. force and effect.
  213.  
  214. 9. Complete Agreement.  This License constitutes the entire agreement
  215. between the parties with respect to the use of the msw to html© Software,
  216. related documentation and data, and supersedes all prior or
  217. contemporaneous understandings or agreements, written or oral, regarding
  218. such subject matter. No amendment to or modification of this License will
  219. be binding unless in writing and signed by the Author or a duly
  220. authorized representative of the Author.
  221.  
  222.  
  223.  
  224.